Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / BACKUP / RCD21.ZIP;1 / RCD.DOC < prev next >

Wrap

Text File | 1993-10-31 | 15.7 KB | 456 lines

RCD version 2.1 (Ray's Change Directory) by Ray Van Tassle 1020 Fox Run Lane Algonquin, Ill, 60102 (708)-658-4941 November 1, 1993 RCD program and manual copyright(c) 1990-1993 by Ray Van Tassle. Abstract: RCD is a set of programs to let you change the default disk/directory quickly & easily, in a "do what I mean" manner. You can specify all or part of the name of the directory you want to go to, and RCD will do it's best to figure out which directory you mean, and on which disk. And with the new systems being delivered with 100+ MB disks standard, you can potentially have a lot of drives, both physical & logical (drives in DOS extended partitions, and in STACKER & SPEEDSTOR compressed volumes). RCD is a companion (but totally independent) program to WIZ, my lightning fast file finder. RCD is shareware, NOT freeware!!! You are granted a limited 21 day evaluation license. At the end of that period, you should either delete it and stop using it, or send in the registration fee of $15. QUICK-START ----------- For a quick start, so you don't have to read this manual, execute "RCDSCAN". Then you can change to ANY directory on any disk by typing "RCD" and all or part of the desired directory name. ACKNOWLEDGEMENTS--and COMPARISION TO OTHER PROGRAMS --------------------------------------------------- Norton's NCD gave me the initial idea for writing RCD, along with ideas on improvement. NCD will only work on the current disk; it has a spiffy user display, but I consider it quite limited in terms of looking at other disks, and weak in finding approximate matches on directory names. Ledbetter's LCD is similar in function to RCD, but isn't quite as powerful in matching, is quite a bit slower in building the index (SCAN), and chokes on network drives that are configured, but off-line (I use $25NETWORK, Little Big Lan, and Fastlynx's EBOX). Time to build index (483 directories on 10 partitions (drives), no disk cache, 7 MHZ 286): RCDSCAN v2.1 LCD v4.00a NCD v4.50 ------------ ---------- --------- 17 seconds 130 seconds 170 seconds LCD does have the capability to do a MD & RD within itself, and make the corresponding change in the index file, but this must be invoked on the DOS command line; it doesn't work with directories created/deleted/renamed/moved internally within other shells or utilities. And RCDSCAN is so fast that it's not a big burden to run it after modifying your directory structure. Directory ordering ------------------ In my first cut at RCD, I didn't sort the directories, but just displayed them in arbitrary order. This was obnoxious, so I then sorted them alphabetically, for each disk. This is kind of like NCD does it, and is exactly the way that LCD does it. But I didn't like that either--it seemed to me that all the directories named "FOO" should be next to one another on the display, no matter what disk they were on. After thinking about it some more, a light dawned: a disk name is really a type of "super directory", especially when you consider large (200MB +) disks divided into several logical partitions. It doesn't make any more sense to group them by disk than it does to group them by parent-directory. So RCD sorts the directories strictly by name, no matter what the parent directory is (be it disk or normal directory). MANUAL ------ RCD is two programs and one data file. The programs are: RCDSCAN - Examines your disks, and builds a data-base containing the directory & disk names. RCD - The program to use in place of CD (or CDD) Command Line format and Switches -------------------------------- RCD [-?] [-p] [-r] [-l] [-m] [-w] directory-name As usual, the stuff inside the square brackets "[]" are optional and may be present or omitted. You do NOT include the brackets in your command line. The various fields and options may appear in any order, in either upper or lower case. The switch character can be either "-" or "/". If you just invoke RCD without any parameters, it gives you a brief help line and shows the current disk & directory. For more info, include '-?'. For even more, include '-??'. The parameter is all or part of the name of the directory you want to switch to. RCD uses the full (better than DOS) wildcard matching that WIZ uses: you can put "*" anywhere, and it matches zero or more characters, "?" matches exactly one character. RCD first looks for a directory name which is exactly the same as the parameter. If it does not find one, it looks for a directory that starts with what you gave. If it does not find one, it then looks for a directory with the characters you gave ANYWHERE in the name. To be more precise, if you said "RCD xyz", the patterns it uses for the match are: 1st try: "XYZ" 2nd try: "XYZ*" 3rd try: "*XYZ*" However, if you include any wildcard characters ("*" or "?"), then RCD will assume that you know what matching pattern you want, and will only do one try, using the exact pattern given. If the directory parameter starts (or ends) with a "\", then this is treated as if the -r (root only) or -l (leaf only) switch was specified. POPUP WINDOW ------------ It is possible that RCD will find more than one directory that satisfies it (for example, I have sub-directories named TRY and TEMP all over my disk). RCD will popup a scrolling window showing all the matching directory names. The cursor will be positioned as follows: If the current directory is NOT a match, the cursor will be on the first line. If the current directory IS a match, then the cursor will be on the next line after the current directory. You can scroll thru the list using the UP/DOWN arrows, and PAGEUP, PAGEDOWN, HOME, and END. Hit ENTER to switch to the highlighted directory. Hit ESC or CTRL/C to bail out. RCD recognizes when your display is set for more than 25 lines (43, 50, or other), and adjusts the number of lines in the window appropriately. -l Leaf directory -------------------- This switch says to only consider a directory that is a leaf (does not have any sub-directories below it). -p Parent directory ---------------------- This is the opposite of -l. It says to only consider a directory if it DOES have at least one sub-directory. -r Root directory -------------------- This says to only consider a directory if it is at the highest level--it's in the root directory of a disk. -m Monochrome display ------------------------ Use this to force a black & white display window. You may also force mono by putting "/m" in the WIZ environment variable. -w Don't do popup window --------------------------- Don't do a popup window if there are several matching directories. Instead, just switch to the "next" directory (according to the rules of positioning the cursor discussed above.) If you re-execute the exact same RCD command, it will step thru all the matching directories in sequence. ************************************************************************* RCDSCAN [-v] [-?] [disks] ----------------- You need to run RCDSCAN whenever you add, delete, move, or rename directories and/or drives. It builds a data-base file containing information about you disk and directory structure. The data base is sorted in alphabetical order, so when RCD shows several matching files, they will be in order, but by the name of the matching directory, NOT in tree order or in sorted order by directory level. This file is: "C:\RCD.IDX" Disk(s): --------------------------- You can specify the disk(s) you want it to scan, optionally followed by ":". It will look at those drives, in the order you listed them. If you list the same one twice, it will look at it twice. You can specify a range of disks by using a dash--"C-F" is the same as "CDEF". CURRENT DISK--- If you start off with ":", rather than a [set of] disk letter(s), then RCD will restrict itself to the current drive. Example: RCD :try -- will look only on the current disk If you don't list any disks, it will look at all drives beginning with C. It will stop when it hits a drive that it cannot read. Processing Disk(s) and Environment Variable ------------------------------------------- You can override the disks that RCDSCAN looks at, and their order, by making an environment variable "WIZ". Do: "SET WIZ=floppy-disk-list:hard-disk-list". Example: "SET WIZ=AB:C-M". What actually happens is that RCDSCAN will try to read all the disks to the left of the colon, then all those to the right of the colon. Those on the left are deemed to be floppies, and will be ignored. Those on the right are deemed to be hard drives, and it will quit on the first one that it can't read. You may omit the "default" disk set by leaving a space after the "=". This is most useful when you need only to put the "/M" switch, as: "SET WIZ= /M". If you specify disks on the command line, it will try to read them all, even if it can't read one. The list may be discontiguous, (e.g., "C-FL-M"). This is mostly useful if you are on a network, which tends to make the networked disks at the higher letters, and leaves a hole before them. Pre-defined Drive Sets ---------------------- You can actually have several pre-defined sets of disks to search. If the disk-specifier on the command line is a single digit (0-9), it will look for that specifier in the WIZ variable. For example, you might say: "SET WIZ=AB:C-F 1=CDEG 2=AB: 3=C-Z 4=C-Z:" As above, those to the left of the colon are deemed floppies; those to the right are hard drives, and RCDSCAN will quit if it can't read one. However, if there isn't a colon, then they are ALL deemed to be hard drives. The command "RCDSCAN ", will look on ABCDEF. The command "RCDSCAN 1:", will look on CDEF. The command "RCDSCAN 2:", will look on AB. The command "RCDSCAN 3:", will look on all drives C-Z (and will quit at the first on that it can't read). The command "RCDSCAN 4:", will look on all drives C-Z (and it will attempt to read each and every one of them). The command "RCDSCAN 9:", will give an error message. -v Verbose ------------- If you have this flag once, RCDSCAN will print the disk name when it starts as it starts on a disk. If you have it twice (-vv), it will also print the name of each directory. This is mostly useful for troubleshooting, or to see a progress indication. It has been tested, and works, with DOS 3.x, including Zenith DOS 3.30, DOS 3.31, DOS 4.01, DOS 5.0, DOS 6.0, STACKER and DoubleSpace compressed pseudo-disks, and On-Track partitioning software. DOS 3.31, 4.01, and 5.0 have large (greater than 32MB) partitions with more than 65,536 sectors. Zenith DOS 3.30 and On-Track have large partitions by virtue of using large sectors (1024, 2048, or 4096 bytes, rather than 512 bytes). Error Messages -------------- "Can't tell if FAT-12 or FAT-16. Assuming FAT-16!" Just what it says. I've only seen this on networked disk drives. If you know how to RELIABLY tell what type of FAT a disk has (other than going thru DOS), please let me know. "malloc failed for FAT_buf!" Can't allocate memory to read a FAT block. Most likely an internal error. "malloc failed for dir_sec_buf!" Can't allocate memory to read in a directory sector. Most likely an internal error. "Sorry, out of memory!!!" You lose. "Can't open file:" Failure to open an archive file. Most likely a disk error. Run CHKDSK. "Non-existant directory, you should run RCDSCAN!" A directory is in the data-base, but does not exist on the disk. It was probably renamed or deleted, but you didn't run RCDSCAN after doing so. BUGS ---- No known bugs. However, RCDSCAN mostly does not use DOS to process a disk, so errors on my part, or a change in the disk structure might break it. If you are having problems, try 1) use the "-v" switch, to isolate the error to a specific disk, 2) use "-vv", to see as it hits each sub-directory. Then call or write me. Coming Attractions ------------------ * Ability to create, delete, rename, and move directories. * Plus other things I think of, or get suggested. This is shareware, so I'm probably more interested and receptive in hearing comments and suggestions than a commercial software publisher would be. Just send them in, or give me a call. I can't promise to fix bugs, or add specific features, but I'll listen to everything. Even if you're cheap and haven't registered. BBS Support & New Versions -------------------------- There is no "official" support BBS. However, I frequent these local BBS's: Chicken Coop (708)658-1545 RIMENET =>THECOOP Emporium (708)551-4275 Fidonet 1:/115/551 Rainbow Draggin' (708)854-1696 Spare phone line in my basement. Update History -------------- 1.4 Initial public release 1.5 Changed to scrollable window display 1.6 Check & report disk read error. 1.7 * Support for network drives * leading :, for current drive only * Fixed bug which sometimes left blank lines. * Leading/trailing "\" 1.9 * Old bug--didn't restore cursor shape properly (RCD). * Fixed bugs with mono detection. * Size window to number of matches. * Fixed RCDSCAN - Would sometimes quit immediately. 2.0 Was never released. 2.1 Now checks for valid directories & directory structure. Fixed a bug in processing large DUBLSPACE disks (DOS 6.0). Fixed bug in window size & [sometimes] blanked out lines. -------------------------- INVOICE / REGISTRATION -------------------------- Sold to: ___________________________________________________ ___________________________________________________ ___________________________________________________ Date: ______________________________ ============================================================ I will normally send you the latest version on 5 1/4" disk. Add $2 for 3 1/2" disk. (Net $22) Delete $5 (per copy) if you DON'T want me to send you a disk! _____ copies of WIZ version ___ at $20 each $____________ _____ copies of RCD version 2.1 at $20 each $____________ _____ add $2 for 3.5" disk $____________ _____ delete $5 per copy for no disk (net $15) DISCOUNT for registering both is $5 off. ____________ TOTAL ENCLOSED....... $____________ NOTE: If you have the current version, I will send you a disk with the NEXT version, when I release it, unless you check here: Ray, YES, send me a disk NOW, even though I already have the current version: [__] Where did you get your copy of RCD? Shareware distributor name:___________________ BBS name: ____________________ BBS phone #: ____________________ Send this invoice and your check to: Ray Van Tassle 1020 Fox Run Lane Algonquin, Il. 60102 (708)-658-4941 ============================================================= Thank you for your support ............... Ray Van Tassle